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Subject: Reporting status from peripheral cevices 


Overview 


A new abies driven mechanism is beinr apawiaed to anaivze 
the status returned by the IOM for peripheral devices and to 
report on error conditions found in the status. This mechanism 
is designed primarily for those devices which are driven throucn 
the I/O Interfacer, but .it is not.limited to such devices. A 
status interpretation table for each different type of peripheral 
device is required. A primitive is provided which is fiven the 
name of the peripheral device, the IOM status, and a pointer to 
the status interpretation table. “This primitive will renort .all 
error conditions found in the status via calls to com_err_. The 
orimitive will also return 18 bits of information to its caller 
to aid in determining what action should be taken on the hasis of 
the status. 


Analyzing termini: scion n status 


when termination status indicating an error is returned by 
the IOM, the following call can be made to analyze the status: 


del. analyze_device_stat_ entry (char (*), ptr, bit (72) 
« @ligned, bit. (18) altened) ; 


call analyze_device_ stat. (devname, tablep, iom_status, 
flags); 


devname is the name of the device for which status 
has: been received. It is used as the first 
argument passed to com_err_. (Input) 


tablep is a pointer to the status interpretation 
| table for the device. See section below for 
a description of the status interpretation 

table format. (Input) 


Multies Project internal working documentation. Not to be 
reproduced or distributed outside the Multics Project. 


iom_ status is the 72 bits of status returned by the IOKM. 
-~ CTAput) 
flags are 18 bits of information designed to aid 


the caller in decidine how to act on the 
Status. Currently, two bits are defined: 
substr (flags, 1, 1) is used to indicate that 


the I/0 operation for which status was 
returned should be re-executed 
unconditionallv. substr (flags, 2, 1) will 


cause substr (flags, 1, 1) to be set if the 
initiation bit in the IOM status is on. That 
is, it will force an indication that the I/0 
operation for which status was returned 
should be re-executed only if it failed 
during initiation of tne operation. (Output) 


Note that analyze _device_stat_ should not be called with I0M 
status that does not indicate an error condition. An error bit 
is provided for such purposes by the I/O Interfacer. Other users 
snould cetermine that one or more of the followings fields in the 
IOM status bits are nonzero before calling analvze_device_stat_: 
power, major status, IOM central status, IOM channel status. 


Pad 


Analyzins system fault status 


Certain serious IOM errors do not cause termination status 


to be stored. Instead, they cause an IOM system fault whicn 
returns I0OM system fault status to the user. This condition is 
indicated by an IOM interrupt level of 1. In this case, A 


different call should be made to analvze the status information: 


declare analyze_system_fault_ entry (char (*), bit (72) 
aliened); 


call analyze_systen fault_ (devname, iom_status); 


(Arcsuments are as above.) 


ine status interpretation tables for each device are coded 
in mexno. bach taole consists of a header, and an array of 
substatuses for eaecn major status which the device can -menerate. 
The format of the table header is as follows: 


declare 1 stable (15) based (tablep) alianed, 
2 offset bit (18) unalirned, 
2 count fixed bin (17) unaligned; 
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is an array which contains an element for 


each possible major status. 


is a ‘relative pointer to the structure 
describing this major status and its possible 
substatuses. 5 Eas offset. 2s zero, the 


corresponding major status is not exnected 
for this device. . 


is a count otf the different substatuses 
expected for this major status. 


status and its associated -substatuses are 


described by the following structure: 


declare 1 sinfo based (sp) aliened,. 


eontrol 


flags 


dese 


2 maj char (24), 

2. sub. Ceount) ; 
3 eontrol char (6), 
3 flags bit (18), 
3 dese char (32); 


is the structure. | 
is a description of the major status. 


is an array of substatuses expected for this 
major status. i . 


is 6 characters of information describing the 


substatus bit. configuration. Only three 
enaracters ‘are permitted in..« the control 
SUPings “O'R. OFT and "x". “In oreger: Tore 
ziven substatus to match a table entrv,. each 
Oo" or "1" in the control string must be 
matched by a corresponding "0" or "1" bit in 
the substatus. Bits corresponding to "x" 


characters are not compared. 


are 18 bits of information which can be used 
to determine what action should be taken for 
this status. See above for a description of 
the defined flaz bits. 


is a description of the substatus. 
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Status Interpretation Table Generation Macros 


Peeler os ee ee a nee ene 


inree macros are provided for the purposes of feneratings a 
status interpretation table for a device. The first of these is 
cesiened to gfenerate the table header. The other two senerate 
the major status and substatus information structures. 


status_table devname, (control) 


This macro sets up the table header and defines a sezdef so 
that the table can be externally accessed symbolicallv. It also 
eauses the symbols "backup" and "initiate" to be defined as 
4QOO0000 octal and 200000 octal respectivelv. These are used in 
setting the flags. 


devname — is the name of the device for which a status 
interpretation table is to be senerated. ‘The 
serment is riven a name or 
devname_status_table". The table header can 
be found at the seadef 
"devname_ status table", 

control is a string of 15 numbers seperated by 
commas. A zero indicates that the 


corresponding major status is not expected 
for this device. A nonzero number indicates 
that the corresponding major status is 
expected and information: describins that 
major status will appear in the status 
interpretation table. | 


status entry maj,(description) 


This macro sets up the major status description. 


maj : is the major status being described. Note 
that this number is decimal. 


description is a character string describing this major 
status. 
Substat entry maj,control,flags,(description) 


This macro sets up infomation for substatus. 


maj 4 is the major status for which this substatus 
applies. Note that this number is decimal. 
control is 5 characters controllinz the examination 


of the substatus as described. above. 
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flags 


description 
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are the 18 bits of action flags described 
above. This number is octal. It may also be 
described symbolically. 


is a character strings deseribinct this 
substatus. 


Appendix 


The mexp macro definitions are viven below for reference: 


' Naero definitions for peripheral status table reneration. 
ip created 12/1/74 by Noel I. Morris 


&macro status_table 


name &1 status_table 

serdef &1_status_table 

bool backup ,400000 retry previous operat 
in 


bool initiate, 200000 set backup flas if 


&1l_status table: 


&(2 ‘ife &i,0 
zero th, 0 
ifend | 
ine. &i,0 
Zero | m&x,ilm&x 
ifend 
&) 
&(2 ine: * &i,0 
set im&x,0 
ifend 
Zend 
&maecro status entry 
m&1: aci HQ" 2QY 
send 
Amacro substat_entry 
set  im&t,im&1+1 
aci "EQ" 6 
vid  018/&3 
aci Vie Re 


“¢eend 


for the card reader: 


tr 
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The following is an example of a status interpretation table 


CRZ_STATUS_ TABLE ~ Status Tables for the. Card Reader. 


coded 12/1/74 by Noel I. Morris 
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% 
Copyright (¢c) 1972 by Massachusetts Institute of # 
Technology and Honeywell Information Systems, Ine. * 
: % 

* 
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&inelude status_table 


status table 


status_entry’ 


status_entry 


substat_entry 
substat_entry 


substat entry . 


substat_entry 


-substat_entry. 
substat_entry. 
substat_entry 


‘status_entry 


substat_entry 


substat_entry 
substat_entry 
substat_entryv 


Status_entry _ 


4 a Ah a We es 6 We rg Oe We rs en 


1,(Device Busy) 


2,(Device Attention) 


2,000000,initiate, (Device off line) 
2,XXX0X1 ,initiate, 

(Hopper emoty or Stacker full) 
2,XXX01X,initiate,(Manual Halt) 
2,0X10XX,initiate,(Feed Alert) 
2,1X10XX,initiate,(Sneak Feed) 


2,X1X0XX,backup,(Card jam) 


2,1X00XX,backup,(Read Alert) 


3, (Device Data Alert) 


3,000001,backunp,. 
(Transfer timing error) 
3,000X10,backup,(Validity check) 


—3,0001X0, backup, (Dual read alert) 


2,001900,backun,(Feed without read) | 


5, (Command Ke ject) 
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substat_entry 
substat_entry 


substat_entry 


status_entry 


substat_entrv 
substat_entry 


substat_entry | 


substat_entry 


status entry 


. Substat_entry 


substat_entry 


status entry 
substat_ entry 
substat_entry 


substat_entry 


end 
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20 backup,(Invalid op ogee 
5,00001X,backup, 

(Invalid device code) 

5,000100, backup ,(IDCW parity error 


10, (MPC Attention) 


10,009001,initiate,(IAI error) 
10,000010,initiate,(DAI error) 
10,000100,initiate, 

(DA Transfer error) | 
10,001000,initiate,(Invalid Punch) 


4 


11,(MPC Data Alert) 


11,000001,backup, 
(Transmission parity error) 
11,000101,backup,(DAI error) 


12,(MPC Command Reject) 


13,000901,baeckup, 

(Illeral procedur e) . 
13,900010,backup, 

(Illegal: loeied) channel) 
73,001000, »backup. (Device reserved) 


